home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / f90 / rtc.z / rtc
Encoding:
Text File  |  2002-10-03  |  3.9 KB  |  91 lines
  1. RTC(3I)                                               Last changed: 4-13-99
  2.  
  3.  
  4. NNAAMMEE
  5.      __rrttcc, RRTTCC, IIRRTTCC, IIRRTTCC__RRAATTEE - Returns clock register contents
  6.  
  7. SSYYNNOOPPSSIISS
  8.      C/C++:
  9.  
  10.      ##iinncclluuddee <<iinnttrriinnssiiccss..hh>>
  11.      lloonngg lloonngg __rrttcc ((vvooiidd));;
  12.  
  13.      CF90 and MIPSpro 7 Fortran 90:
  14.  
  15.      RRTTCC (())
  16.      IIRRTTCC (())
  17.  
  18.      MIPSpro Fortran 77:
  19.  
  20.      IIRRTTCC__RRAATTEE(())
  21.  
  22. IIMMPPLLEEMMEENNTTAATTIIOONN
  23.      UNICOS, UNICOS/mk, IRIX systems
  24.  
  25.      Cray C/C++, CF90, MIPSpro 7 Fortran 90, MIPSpro Fortran 77
  26.  
  27. SSTTAANNDDAARRDDSS
  28.      C/C++ extension
  29.  
  30.      Fortran extension
  31.  
  32. DDEESSCCRRIIPPTTIIOONN
  33.      The __rrttcc, RRTTCC, and IIRRTTCC intrinsic functions return a real-time clock
  34.      value.  The value is expressed as the number of _c_l_o_c_k _t_i_c_k_s.  The
  35.      IIRRTTCC__RRAATTEE function returns the clock rate of the IIRRTTCC and RRTTCC
  36.      functions.
  37.  
  38. NNOOTTEESS
  39.    CC//CC++++
  40.      Because __rrttcc is an intrinsic function, no externally visible library
  41.      function is available for it.  The compiler generates inline code to
  42.      produce the result.
  43.  
  44.    FFoorrttrraann
  45.      The names of these intrinsics cannot be passed as arguments.
  46.  
  47.      When RRTTCC is called as a subroutine, it accepts the following argument:
  48.  
  49.      _t_i_m_e   The real-time clock value is returned as a RREEAALL((KKIINNDD==88)) value.
  50.  
  51.      When IIRRTTCC is called as a subroutine, it accepts the following
  52.      argument:
  53.  
  54.      _i_t_i_m_e  The real-time clock value is returned as an IINNTTEEGGEERR((KKIINNDD==88))
  55.             value.
  56.  
  57.      The RRTTCC intrinsic function is outmoded.  For information on outmoded
  58.      features and their preferred standard alternatives, see the _F_o_r_t_r_a_n
  59.      _L_a_n_g_u_a_g_e _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, _V_o_l_u_m_e _3.
  60.  
  61.      The use of RRTTCC is not recommended on UNICOS or IRIX systems.  See the
  62.      standard SSYYSSTTEEMM__CCLLOOCCKK(3I) intrinsic subroutine for the preferred
  63.      alternative.
  64.  
  65. FFOORRTTRRAANN RREETTUURRNN VVAALLUUEESS
  66.      RRTTCC returns a 64-bit real value.  IIRRTTCC returns a 64-bit integer value.
  67.  
  68.      When using CF90 on a UNICOS system, RRTTCC returns the low-order 46 bits
  69.      of the clock register as a RREEAALL((KKIINNDD==88)) value.  IIRRTTCC returns the
  70.      current content of the clock register as an IINNTTEEGGEERR((KKIINNDD==88)) value.
  71.      The result of IIRRTTCC may exceed 2**(46)-1 and must not be used in
  72.      multiplication, division, or conversion to real unless the value is
  73.      typed as a 64-bit integer in the CF90 program or --OO nnooffaassttiinntt is
  74.      specified on the ff9900(1) command line.  Addition and subtraction are
  75.      unaffected.
  76.  
  77.      On IRIX systems, RRTTCC returns the low-order 52 bits of the system clock
  78.      expressed as a RREEAALL((KKIINNDD==88)) value.  IIRRTTCC returns the system clock as
  79.      an IINNTTEEGGEERR((KKIINNDD==88)) value.  IIRRTTCC__RRAATTEE returns the number of IIRRTTCC and
  80.      RRTTCC clock ticks per second in an IINNTTEEGGEERR((KKIINNDD==88)) value.  IIRRTTCC is the
  81.      fastest nonwrapping clock.
  82.  
  83. SSEEEE AALLSSOO
  84.      A complete list of C/C++ intrinsic functions available on UNICOS and
  85.      UNICOS/mk systems is in the _C_r_a_y _C/_C++ _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l.
  86.  
  87.      ff9900(1), SSEECCOONNDD(3F), SSYYSSCCLLOOCCKK(3F), SSYYSSTTEEMM__CCLLOOCCKK(3I), TTSSEECCNNDD(3F)
  88.  
  89.      _I_n_t_r_i_n_s_i_c _P_r_o_c_e_d_u_r_e_s _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l for the printed version of this
  90.      man page.
  91.